Micron Document

Rnsh
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

rnsh is a utility bundled with RNS that facilitates interactive shell sessions over Reticulum, akin to SSH. It supports full terminal emulation including escape sequences, window resizing, signal forwarding, and piping of standard input, output and error streams.

rnsh can operate in two modes:

listener mode – accepts incoming connections
initiator mode – connects to a remote listener

Both sides authenticate using Reticulum identities, ensuring that only authorized peers can establish sessions. By default, only whitelisted identities may connect to a listener.

Note: As with SSH, anyone connecting to the listener will have the same permissions as the user running the listener, including potentially root privileges.

Contents

Usage

Usage

On the remote machine, run in listener mode with rnsh --listen --allowed <identity> where <identity> is the identity on the machine you want to connect from. You should see rnsh listening for commands on <destination> printed to the terminal, showing the destination of the listener.

On the local machine, run in initiator mode with rnsh <destination> to connect to the remote machine. If the local machine has the specified <identity>, the connection should be successful.

For more examples, see Usage Examples in the manual.

See also

rncp
rnx

RNS utilities

rncprngitrnidrnirrnodeconfrnpathrnpkgrnprobernshrnstatusrnx